docs(skills): update upgrading-sdk-v2 with ActionError adoption and local CI validation#36
Merged
TheRealAgentK merged 2 commits intomasterfrom Apr 21, 2026
Conversation
Agent skill for AI coding assistants (Amp, Claude Code) that automates upgrading integrations from SDK 1.x to 2.0.0. Covers source code (context.fetch → FetchResponse.data), test mock updates, requirements.txt, and config.json version bump. Includes skills/README.md with setup instructions for workspace-level and global installation.
…ocal CI validation - Document ActionError (SDK 1.1.0) adoption as part of the upgrade - Document execute_action ValidationError → ResultType change - Make local CI validation a required step with exact commands - Add ruff config caveat (line-length=120 vs default 88) - Add CI fetch pattern linter false-positive caveat - Expand checklist and gotchas sections Closes #35
Coverage —
|
| File | Stmts | Miss | Cover | Missing |
|---|---|---|---|---|
src/autohive_integrations_sdk/__init__.py |
2 | 0 | 100% | |
src/autohive_integrations_sdk/integration.py |
358 | 0 | 100% |
ProRedCat
approved these changes
Apr 21, 2026
Collaborator
Author
|
Thx @ProRedCat - @NinosMan please have a look at the skill regardless - if there's comments and changes from your point of view, we can add them in another PR. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the
upgrading-sdk-v2agent skill based on lessons learned from upgrading 6 integrations in Autohive-AI/autohive-integrations#258.Closes #35
Changes
ActionError adoption (new section)
ActionErroras a required adoption during the 2.0.0 upgradeexecute_actionbehavior change (new in Step 5C)ValidationErroris no longer raised — returnsResultType.VALIDATION_ERRORinsteadpytest.raises(ValidationError)→ result type checkLocal CI validation (Step 7 rewrite)
validate_integration.py,check_code.py--config ../autohive-integrations-tooling/ruff.toml(line-length=120vs default 88)CI fetch pattern linter caveat (new in Step 7E + Gotcha 7)
responsewhen a helper already unwraps.datagql_result,body,api_dataExpanded checklist